home *** CD-ROM | disk | FTP | other *** search
/ C/C++ 3D Game Tools / C-C++ 3D Game Tools.iso / ziptools / arj / ncav31a.arj / AVIEW.DOC < prev    next >
Encoding:
Text File  |  1993-08-29  |  16.5 KB  |  389 lines
  1.  
  2. ┌─────────────────────────────────────────────────────────────────────────────┐
  3. │  ████┐  ██┐ ██┐ ██┐ ██████┐ ██┐  ██┐                                        │
  4. │ ██┌─██┐ ██│ ██│ ██│ ██┌───┘ ██│  ██│                            AVIEW V3.1a │
  5. │ ██████│ ██│ ██│ ██│ █████┐  ██│█┐██│                                        │
  6. │ ██┌─██│ └█│ █┌┘ ██│ ██┌──┘  ███┌███│                                        │
  7. │ ██│ ██│  └██┌┘  ██│ ██████┐ ██┌┘└██│   Copyright (C) 1992-93 by Chris Buijs │
  8. │ └─┘ └─┘   └─┘   └─┘ └─────┘ └─┘  └─┘                                        │
  9. └─────────────────────────────────────────────────────────────────────────────┘
  10.  
  11.   AVIEW is a simple archive-viewer utility for the Norton Commander, it
  12.   views ARC, ARJ, LZH, PAK, ZIP and ZOO archives automatically, it shows
  13.   lots of info's about the files in the archive, you can also tag files and
  14.   unpack them, all operations also work on archive-in-archive!
  15.  
  16.  
  17.   AVIEW is made for usage under the Norton Commander, however, the Norton
  18.   Commander is NOT needed to use AVIEW, AVIEW can also be used stand-alone.
  19.  
  20.  
  21.   This utility is here-by placed in Public Domain and can be concidered
  22.   freeware, this utility may not be sold, hired, leased or modified, it may
  23.   be freely copied as a complete package.
  24.  
  25.  
  26.   This documentation is a quick-help to setup AVIEW, for more information
  27.   you can study the AVIEW.CTL and WHATSNEW.31 files.
  28.  
  29. ┌─────────────────────────────────────────────────────────────────────────────┐
  30. │ ▒▒▒▒ Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  31. └─────────────────────────────────────────────────────────────────────────────┘
  32.  
  33.   AVIEW requires:  MS/PCDOS V3.3x or higher
  34.                    290 KB of free conventional memory.
  35.                    A mouse (optional).
  36.  
  37.   The following programms may be needed (optional);
  38.  
  39.   For extracting, updating, converting and viewing archives-in-archives:
  40.   ───────────────────────────────────────────────────────────────────────────
  41.   ARJ.EXE                   from Robert K. Jung.
  42.   LHA.EXE                   from Haruyasu Yoshizaki.
  43.   PAK.EXE                   from NoGate Consulting.
  44.   PKUNPAK and PKPAK         from PKWare.
  45.   PKUNZIP.EXE and PKZIP.EXE from PKWare.
  46.   ZOO.EXE                   from Rahul Dhesi.
  47.  
  48.  
  49.   For file-viewing/editing:
  50.   ───────────────────────────────────────────────────────────────────────────
  51.   WPVIEW.EXE                from Symantec (Peter Norton Computing).
  52.   NCEDIT.EXE                from Symantec (Peter Norotn Computing).
  53.  
  54.  
  55.   All the above programms are optional and can be replaced by others, this
  56.   can be done by changing the parameters in the AVIEW.CTL file.
  57.  
  58. ┌─────────────────────────────────────────────────────────────────────────────┐
  59. │ ▒▒▒▒ Parameters ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  60. └─────────────────────────────────────────────────────────────────────────────┘
  61.  
  62.   Syntax:  AVIEW [[<Drive>:][<Path>\][<Filename>]] [/?] [/M] [/25] [/35]
  63.                  [/40] [/43] [/50]
  64.  
  65.            <Drive>:   - Drive where archive is on.
  66.  
  67.            <Path>\    - Path where archive is stored.
  68.  
  69.            <Filename> - Archive-file.
  70.  
  71.            /?         - Gives a help-screen about the parameters.
  72.  
  73.            /M         - Starts up AVIEW in monochrome mode.
  74.  
  75.            /25        - Starts up AVIEW in 25 lines per screen mode.
  76.  
  77.            /35        - Starts up AVIEW in 35 lines per screen mode (EGA).
  78.    
  79.            /40        - Starts up AVIEW in 40 lines per screen mode (EGA)
  80.  
  81.            /43        - Starts up AVIEW in 43 lines per screen mode (VGA)
  82.  
  83.            /50        - Starts up AVIEW in 50 lines per screen mode (VGA)
  84.  
  85.  
  86.   When no drive/path/file parameters are given, AVIEW will startup with a
  87.   file-selector, with this file-selector you can select a file to view,
  88.   with the file-selector you can also switch between drives, directorys
  89.   and files.
  90.  
  91.   When only a drive or path is given as parameter, aview will startup the
  92.   file-selector in the given drive/directory.
  93.  
  94.   AVIEW automatically detects how many lines per screen are used at startup
  95.   and will use the number of lines per screen detected, this can be
  96.   overridden with the above parameters or with the SCREENMODE parameter in
  97.   the AVIEW.CTL file.
  98.  
  99. ┌─────────────────────────────────────────────────────────────────────────────┐
  100. │ ▒▒▒▒ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  101. └─────────────────────────────────────────────────────────────────────────────┘
  102.  
  103.   STANDALONE
  104.   ───────────────────────────────────────────────────────────────────────────
  105.   - Copy AVIEW.EXE and AVIEW.CTL to a directory in your PATH, AVIEW.CTL must
  106.     be located in the same directory as AVIEW.EXE.
  107.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  108.     parameters so that AVIEW will work on your system correctly.
  109.   - Your now ready to run AVIEW.
  110.  
  111.     
  112.   THE NORTON COMMANDER Versions prior to V4.0
  113.   ───────────────────────────────────────────────────────────────────────────
  114.   - Copy AVIEW.EXE, AVIEW.CTL and AVIEWNC.EXE to the directory where
  115.     the Norton Commander is installed.
  116.   - Run the AVIEWNC utility, this utility will update your NC.EXT file.
  117.   - Delete AVIEWNC.EXE, only needed for installing AVIEW in the NC.EXT file.
  118.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  119.     parameters so that AVIEW will work on your system correctly.
  120.   - Restart The Norton Commander.
  121.   - Your now ready to run AVIEW.
  122.  
  123.     NOTE: After installing AVIEW in The Norton Commander, you can view an
  124.           archive by pressing ENTER or F3.
  125.  
  126.  
  127.   THE NORTON COMMANDER V4.0
  128.   ───────────────────────────────────────────────────────────────────────────
  129.   - Copy AVIEW.EXE, AVIEW.CTL and AVIEWNC4.EXE to the directory where
  130.     the Norton Commander is installed.
  131.   - Run the AVIEWNC4 utility, this utility will update your NC.CFG and
  132.     NC.EXT files.
  133.   - Delete AVIEWNC4.EXE, only needed for installing AVIEW in the NC.CFG and
  134.     NC.EXT files.
  135.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  136.     parameters so that AVIEW will work on your system correctly.
  137.   - Restart The Norton Commander.
  138.   - Your now ready to run AVIEW.
  139.  
  140.     NOTE: When you run AVIEW under The Norton Commander V4.0, you can only
  141.           use AVIEW on a file by pressing F3, when you press ENTER in
  142.           NC V4.0, the internal file-view will be activated, this CANNOT
  143.           be changed to use AVIEW instead.
  144.  
  145.     NOTE 2: I discovered that when you use F3 under the
  146.             Norton Commander V4.0 that NC doesn't swap itself out of memory,
  147.             this leaves not enough memory for AVIEW to view archives from
  148.             the root-directory of diskettes (viewing from a directory of a
  149.             diskette gives no problem), i'm working on this to fix.   
  150.  
  151. ┌─────────────────────────────────────────────────────────────────────────────┐
  152. │ ▒▒▒▒ AVIEW.CTL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  153. └─────────────────────────────────────────────────────────────────────────────┘
  154.  
  155.   You can edit the AVIEW.CTL file, its a plain ascii-file, see the example
  156.   AVIEW.CTL for more information, the following commands can be used to
  157.   configure AVIEW:
  158.  
  159.  
  160.   BACKUP <Extension>
  161.   ───────────────────────────────────────────────────────────────────────────
  162.   With this command you tell AVIEW the extension of a backup-file created by
  163.   your editor (if any), AVIEW will delete this file after an edited file is
  164.   updated in an archive.
  165.  
  166.  
  167.   NOCOLOR
  168.   ───────────────────────────────────────────────────────────────────────────
  169.   With this command you force AVIEW in black and white mode, this can be
  170.   handy for laptop-users with LCD-Screens.
  171.  
  172.  
  173.   NOMOUSE
  174.   ───────────────────────────────────────────────────────────────────────────
  175.   When you have a mouse, and it is detected by AVIEW, you can force AVIEW 
  176.   with this command to ignore the mouse and not use it.
  177.  
  178.  
  179.   VIEWER <Trigger> <Viewer> [<Parameters>]
  180.   ───────────────────────────────────────────────────────────────────────────
  181.   With this command you can define up to 16 viewers to use to view files from
  182.   an archive, <Trigger> is a file-extension which triggers <Viewer> when a
  183.   file is viewed, <Trigger> must not be more then 3 chars and may include
  184.   wildcards, DON'T include the period (.) in the trigger-extension.
  185.   When no viewers are defined, WPVIEW is taken for all type of files.
  186.  
  187.  
  188.   EDITOR <Editor> [<Parameters>]
  189.   ───────────────────────────────────────────────────────────────────────────
  190.   For defining the editor to use with the edit-function, when no editor is
  191.   defined, NCEDIT is taken as the default.
  192.   NOTE: Use only a editor which doesn't create any backup-files!
  193.  
  194.  
  195.   EXTRACTPATH <Path>
  196.   ───────────────────────────────────────────────────────────────────────────
  197.   The path to use for extracting files to, when this path isn't defined,
  198.   AVIEW will prompt for a path before extracting any files.
  199.  
  200.  
  201.   SCREENMODE <Lines>
  202.   ───────────────────────────────────────────────────────────────────────────
  203.   With this statement you can define how many lines per screen AVIEW must
  204.   use, valid numbers are 25, 35, 40, 43 and 50, note that you will need an
  205.   EGA or VGA adaptor when you use numbers greater than 25.
  206.  
  207.   SORT <Key> [Ascending|Descending]
  208.   ───────────────────────────────────────────────────────────────────────────
  209.   With this parameter you define how to sort the file-list as default, there
  210.   are 6 sort-keys:
  211.  
  212.     NAME      - For sorting on file-name
  213.     EXTENSION - For sorting on file-extension.
  214.     ORGSIZE   - For sorting on original (uncompressed) file-size.
  215.     CMPSIZE   - For sorting on compressed file-size.
  216.     DATETIME  - For sorting on date and time.
  217.     METHOD    - For sorting on compression-method.
  218.  
  219.   Optional you can also define the sort-direction, two keywords are
  220.   availble:
  221.  
  222.     ASCENDING  - Sort ascending.
  223.     DESCENDING - Sort descending.
  224.   
  225.   The default is sorting on filename, ascending.
  226.  
  227.  
  228.   TEMPPATH <Path>
  229.   ───────────────────────────────────────────────────────────────────────────
  230.   With this command you define the path AVIEW must use as work-directory,
  231.   this can be a ram-drive which will speed-up AVIEW dramatically, in this
  232.   directory AVIEW will creates its own tempory directorys, these tempory
  233.   directorys will be deleted when AVIEW doesn't need them anymore, note
  234.   that the directory specified with TEMPPATH is NOT deleted, nor the
  235.   files that exist in it, this has been changed since V3.0.
  236.  
  237.  
  238.   SCANNER [<Path>\]<Filename> [<Parameters>]
  239.   ───────────────────────────────────────────────────────────────────────────
  240.   With this command you can define the virus-scanner to use for scanning the
  241.   file unpacked with the unpack function, when no virus-scanner is defined,
  242.   NO scan will be performed.
  243.  
  244.   ┌─────────────────────────────────────────────────────────────────────────┐
  245.   │ With the following commands you can define the parameters used by AVIEW │
  246.   │ for using the external archive-utilitys.                                │
  247.   │ For normal operation of AVIEW, you don't need to change this, all the   │
  248.   │ following commands are optional, the sample commands in the sample      │
  249.   │ AVIEW.CTL file reflects the standard default configuration of AVIEW.    │
  250.   └─────────────────────────────────────────────────────────────────────────┘
  251.  
  252.  
  253.   xxxADD <Command-line>
  254.   xxxDELETE <Command-Line>
  255.   xxxEXTRACT <Command-Line>
  256.   xxxUNPACK <Command-Line>
  257.   xxxUPDATE <Command-Line>
  258.   xxxRESPONSE <Response-char>
  259.   ───────────────────────────────────────────────────────────────────────────
  260.   With these commands you can configure the interface between AVIEW and the
  261.   external archive-utilitys, the xxx can be ARC, ARJ, LHA, PAK, ZIP or ZOO.
  262.   xxxADD      - Defines which parameters to use for adding a file to
  263.                 an archive, this is used for the ADD function (F7).
  264.   xxxDELETE   - Defines which parameters to use for deleting a file or files
  265.                 from an archive, this is used for the DELETE function
  266.                 (F8 or DEL).
  267.   xxxEXTRACT  - Defines which parameters to use for extracting a file or files
  268.                 from an archive, this is used for the extract-function.
  269.   xxxUNPACK   - Defines which parameters to use for extracting ONE file from
  270.                 an archive WITHOUT path, this is used internally in AVIEW.
  271.   xxxUPDATE   - Defines which parameters to use for updating a file in an
  272.                 archive, this is used after you edited a file from an archive.
  273.   xxxRESPONSE - Defines which charachter to use before a file name to tell
  274.                 the archiver that it is a response file, AVIEW defines
  275.                 automatically when to use this or not.
  276.  
  277.   NOTE: There are two variables, %A and %F, thes two must ALWAYS exist in one
  278.         of the above parameters (except xxxRESPONSE), %A will be replaced by
  279.         AVIEW with the name of the archive processed, and %F with a filename
  280.         for adding/deleting/updating, note that AVIEW will automatically add
  281.         the response-file-char before the filename when needed.
  282.         The variables %A and %F are NOT optional!
  283.  
  284. ┌─────────────────────────────────────────────────────────────────────────────┐
  285. │ ▒▒▒▒ Operation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  286. └─────────────────────────────────────────────────────────────────────────────┘
  287.  
  288.   MOUSE:
  289.   ───────────────────────────────────────────────────────────────────────────
  290.   AVIEW has mouse-support, when a mouse is detected it will be used
  291.   automatically, the mouse is used in file-lists, menu's and the
  292.   file-selector.
  293.  
  294.   Click once on an entry to highlight it, click it twice for selecting it.
  295.  
  296.   Clicking at the top of bottom of a menu, or at the top of bottom of a
  297.   file-list screen of will scroll the cursor-bar.
  298.  
  299.   The function-keys at the bottom of the screen can offcourse also be clicked.
  300.  
  301.   The right mouse-button will act as the ESC key.
  302.  
  303.  
  304.   Archive-Viewing Keys:
  305.   ───────────────────────────────────────────────────────────────────────────
  306.   F1           - Help, some info which keys you can use.
  307.  
  308.   F2           - Unpack, extracts file under selection-bar or all tagged 
  309.                  files from archive.
  310.  
  311.   Shift-F2     - Same as F2 only now you can enter an extraction-path.
  312.  
  313.   F3 or ENTER  - View file, also for archive-in-archive.
  314.  
  315.   F4           - Edit file, after editing AVIEW will ask if you want to update
  316.                  the archive with the edited file.
  317.  
  318.   F5           - Convert, you can convert the archive you are viewing to
  319.                  another archive-format, this works only if AVIEW isn't
  320.                  nested for viewing archives within archives.
  321.  
  322.   F6 or ALT-S  - Sort, sort file list.
  323.  
  324.   F7           - Add, add files to archive, when on the input-field, press
  325.                  F2 to activate the file-selector.
  326.  
  327.   F8 or DEL    - Delete, Delete file under selection-bar or all tagged files
  328.                  from archive.
  329.  
  330.   F9 or ALT-J  - jump to DOS.
  331.  
  332.   F10 or ESC   - Step back one archive when nested-viewing is used, or exit.
  333.  
  334.   INS or SPACE - Tag/Untag files.
  335.  
  336.   Gray +       - Wildcard selection.
  337.  
  338.   Gray -       - Wildcard de-selection.
  339.  
  340.   Gray *       - Revert selection.
  341.  
  342.  
  343.   File-Selector Keys:
  344.   ───────────────────────────────────────────────────────────────────────────
  345.   F1           - Help, some info which keys you can use.
  346.  
  347.   F2           - Change drive/directory.
  348.  
  349.   F3 or ENTER  - Select a drive/directory or file to view.
  350.  
  351.   F6           - Rename directory/file.
  352.  
  353.   F7           - Create directory.
  354.  
  355.   F8 or DEL    - Delete directorys/files.
  356.  
  357.   F9 or ALT-J  - jump to DOS.
  358.  
  359.   F10 or ESC   - Quit.
  360.  
  361.   INS or SPACE - Tag/Untag files.
  362.  
  363.   Gray +       - Wildcard selection.
  364.  
  365.   Gray -       - Wildcard de-selection.
  366.  
  367.   Gray *       - Revert selection.
  368.  
  369. ┌─────────────────────────────────────────────────────────────────────────────┐
  370. │ ▒▒▒▒ Contact/Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  371. └─────────────────────────────────────────────────────────────────────────────┘
  372.  
  373.   For bug-reports, suggestions and other things concerning AVIEW you can
  374.   contact me at the following BBS:
  375.  
  376.     Action Board Zaandam
  377.     +31-(0)75-704890
  378.     1200, 2400 and 9600 HST V42/V42Bis.
  379.     Located in The Netherlands
  380.     24 Hours a day reachable.
  381.  
  382.   Just try to yell the sysop or write a message to me.
  383.  
  384.   I can also can be reached on COMPUSERVE under 100117, 3242 (Chris Buijs).
  385.  
  386.  
  387.                                         Have Fun,
  388.                     Chris Buijs
  389.